.NET MAUI 教程

设置开发环境并生成第一个 .NET 多平台应用 UI (.NET MAUI)应用。

检查 Visual Studio 2022 的系统要求。

检查 Visual Studio for Mac 2022 的系统要求和 Xcode 最新版的最低要求。

10分钟 + 下载/安装时间

在 Windows 和 Android 上运行的移动和桌面应用，它显示了一条消息: Hello, World!。

在 Mac 和 Android 上运行的移动和桌面应用，它显示了 Hello, World! 消息。

下载并安装 Visual Studio 2022。

下载 Visual Studio 2022

在安装过程中，应选择“.NET Multi-platform App UI 开发”工作负载。使用上面的链接时应预先正确选择所有先决条件，如下图所示:

如果已有 Visual Studio 2022，则可以更新安装以添加 .NET MAUI 支持:

下载并安装 Visual Studio 2022 for Mac。

下载 Visual Studio 2022 for Mac

在安装过程中，请确保选择了以下工作负载:

选择 .NET MAUI 后，应会自动选择最后两个工作负载(Android 和 iOS)。

本教程针对最新版本的 Visual Studio for Mac 进行了优化。如果已有 Visual Studio 2022 for Mac，则可以检查更新:

要生成.NET MAUI 应用，还需要:

Xcode 最新版本

一个 Apple ID

如果你没有 Apple ID，可以在 https://appleid.apple.com 创建一个。安装和登录 Xcode 需要 Apple ID。

安装 Xcode 后，如果出现提示，则必须打开 Xcode，同意服务条款并安装可选组件。

新建 .NET MAUI 应用:

在“创建新项目”窗口中，从“所有项目类型”下拉列表中选择“MAUI”，选择“.NET MAUI 应用”模板，然后单击“下一步”按钮。

在“配置新项目”窗口中，输入“MyFirstMauiApp”作为项目名称，然后单击“下一步”按钮。

在“其他信息”窗口中，如果尚未选择，则在“框架”下拉列表中选择“.NET 7.0 (标准期限支持)”，然后单击“继续”按钮。

Visual Studio 创建新项目。如果收到 Windows 安全中心警报，警告防火墙阻止了某些功能，请选择“允许访问”按钮。

NuGet 是一个包管理器，它将引入新应用的依赖项。

包还原过程将自动启动。请等候，直到 已还原 或 就绪 消息显示在屏幕左下角的状态栏中。

在“选择新项目的模板”窗口中，选择“多平台”>“应用”，选择“.NET MAUI 应用”模板，然后单击“继续”按钮。

在“配置新的 .NET MAUI 应用”窗口中，如果未选择，则在“目标框架”下拉列表中选择“.NET 7.0”，然后单击“继续”按钮:

输入“MyFirstMauiApp”作为项目名称，然后单击“创建”按钮。

本教程将首先重点介绍如何将 .NET MAUI 应用程序部署到本地 Windows 计算机。然后可以选择设置 Android 设备或仿真器。

在 Visual Studio 工具栏中，应默认将“Windows 计算机”视为调试目标。按“Windows 计算机”按钮生成并运行应用:

如果尚未启用开发人员模式，Visual Studio 将提示你启用它。在“为 Windows 启用开发人员模式”对话框中，单击“面向开发人员的设置”链接以打开“设置”应用:

在“开发人员模式”下打开开关。

显示了使用开发人员功能对话框。选择是确认要启用开发人员模式。

关闭“设置”应用，然后关闭“为 Windows 启用开发人员模式”对话框。应用应开始运行。

在正在运行的应用中，选择“单击这里”按钮几次，并观察按钮单击次数的计数是递增的:

本教程将首先重点介绍如何将 .NET MAUI 应用程序部署到本地 Mac 计算机。然后，你可以选择设置 Android 设备或仿真器。

在 Visual Studio 工具栏中，默认情况下，应将“我的 Mac”视为调试目标。按“播放”图标(▶)生成并运行应用:

在正在运行的应用中，选择“单击这里”按钮几次，并观察按钮单击次数的计数是递增的:

恭喜，你已生成并运行第一个 .NET MAUI 应用! 使应用保持运行并继续学习本教程。

当使用 .NET MAUI 开发应用程序时，在调试应用程序时可使用 XAML 热重载。这意味着可以在应用程序运行时更改 XAML 用户界面(UI)，并且 UI 将自动更新。

返回到 Visual Studio，使应用保持运行状态。在“解决方案资源管理器”中，双击 MyFirstMauiApp 项目下的 MainPage.xaml 文件。如果看不到“解决方案资源管理器”窗格，请从主菜单中选择“视图”>“解决方案资源管理器”(或按 Ctrl+ALT+L)。

返回到 Visual Studio，并使应用保持运行状态。在“解决方案”窗口中，双击“MyFirstMauiApp”项目下的“MainPage.xamll”文件。如果看不到“解决方案”窗口，请从主菜单中选择“视图”>“解决方案”。

目前，第一个 Label 的 Text 设置为 Hello, World!如以下代码所示:

将文本更新为 Hello, .NET MAUI!:

在你进行更改时，应用 UI 会自动更新。

使用 .NET MAUI 开发应用程序时，还可以使用 .NET 热重载重新加载 C# 代码。我们来修改应用程序中的逻辑，以在单击按钮时将计数增加 10 而不是 1。

打开 MainPage.xaml.cs (此文件嵌套在 MainPage.xaml 下，或者可以右键单击并从菜单中选择“查看代码”)。

该文件上的 OnCounterClicked 方法当前具有以下代码:

更新 count++;，让它按 10 递增，方法是将其更改为 count += 10;。

若要应用代码更改，请在 Visual Studio 中选择热重载按钮，或选择 ALT+F10。

选择“单击这里”按钮，你将看到其按 10 递增。很棒! 现在可以关闭正在运行的应用。

可以根据开发环境决定部署到一个或多个平台。你刚刚运行应用并将其部署到 Windows。现在，我们来设置一个 Android 设备或仿真器。

从调试目标下拉菜单中，在“框架”下选择“net7.0-android”。

生成项目需要特定版本的 Android SDK。如果尚未接受 Android SDK 许可证，则会在“错误列表”窗口上看到以下错误消息。

双击消息以启动许可证接受过程。为每个出现的许可证单击“接受”，然后将开始自动安装。

如果没有要部署到的 Android 设备，可以按照以下步骤设置 Android 仿真器。如果已执行此操作或想要使用自己的 Android 设备，则可以跳过此步骤。

如果这是你第一次构建 .NET MAUI 应用程序，则会在调试目标下拉菜单中看到选中了 Android Emulator。单击它即可开始创建过程。如果出现许可证接受对话框，请选择“接受”。

此时将打开“新设备”窗口。请选择“创建”按钮以使用默认设置创建仿真器。这将下载仿真器图像并完成仿真器的创建以在 Visual Studio 中使用。此步骤可能需要一段时间。

创建仿真程序后，将会看到一个按钮，显示“开始”。单击此按钮。

你可能会收到启用 Windows 虚拟机监控程序平台的提示。按照文档启用加速以提高性能(需要让仿真器启动并运行)。

Android 仿真器将启动。等待它完全启动后，你将看到它会显示在 Visual Studio 调试菜单中。这可能需要一些时间。

你的 Android 仿真器现已创建并可供使用。下次运行 Visual Studio 时，仿真器将直接显示在调试目标窗口中，并在选择它时启动。如果遇到任何问题或模拟器存在性能问题，请阅读 完整安装文档。

可以根据开发环境决定部署到一个或多个平台。你刚刚运行应用并将其部署到 Mac。现在，我们来设置一个 Android 设备或仿真器。

如果是首次生成 .NET MAUI 应用程序，则需要创建新的 Android Emulator。你将在调试菜单中看到“Android Emulator”。按“播放”图标(▶)以开始创建过程。

系统会自动为基本模拟器填充选项。如果需要，请更改任意选项，然后选择“ 创建”。

此时，系统可能会提示你同意 Android Emulator 的许可协议。请阅读并选择“接受”以继续此流程。此操作会下载仿真程序映像并完成创建，以便在 Visual Studio 中使用仿真程序。

创建仿真器后，将会看到一个按钮，显示“播放”。请单击此按钮。

Android 仿真器将启动。等待它完全启动后，你将看到它会显示在 Visual Studio 调试菜单中。如果不使用硬件加速，这个过程可能需要一些时间。

你的 Android 仿真器现已创建并可供使用。下次运行 Visual Studio 时，仿真器将直接显示在调试目标窗口中，并在选择它时启动。如果遇到任何问题或模拟器存在性能问题，请阅读 完整安装文档。

若要使用 Android 设备进行开发，需要启用 USB 调试。请在设备上执行以下步骤，将设备连接到 Visual Studio。如果没有 Android 设备，可以跳过此部分。

启用开发人员模式

检查 USB 调试状态

信任设备

你的设备现在已配置，并将作为部署目标显示在 Visual Studio 中。

有任何问题?查看此文档。

现在应该配置仿真程序或设备，以进行部署!

确保将设备或仿真器选作调试目标。

在菜单中选择“调试”>“开始调试”(或按 F5)。如果禁用此选项，请确保已选择仿真器或设备。

在菜单中选择“调试”>“启动调试”。如果禁用了此选项，请确保已选择模拟器或设备。

应用程序将生成、部署到所选 Android 设备/仿真器，然后运行。

恭喜你已生成并运行自己第一个 .NET MAUI 应用!

现在，你已掌握基本信息，请继续学习如何在 Microsoft Learn 上通过自我引导式学习路径构建 .NET MAUI 应用。

.NET MAUI 学习路径

让 James 逐步指导你从头到尾构建完整的.NET MAUI 应用:

你可能还会关注...

使用 .NET MAUI 的文档进行更深入发掘

在 GitHub 上浏览 .NET MAUI 示例